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ApplirntionMediotorlmoI.exitO : AUS8- 1999-0694 
/** 

* the Applicotictiidediiiioi by exiling oil allocated ViewControllers 

♦ and ApplicationMediators. All data is set to null, and lists are 

* destroyed. An 'exited* ApplicationMediotor cannot be used again. 
« If this method is overriden in a subclass, be sure to invoke 

♦ super.exitQ; 

••/ 

public void exit() { 

synchronized (this) j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventThread !=null) } 
// tryj 

// eventThread.stop (); 

// \ catch (Exception e) | 

'/n ! 

/* Used for style 2 event dispatching. Leave this code commented. */ 
for (int i = 0; i < runningThreads.size(); j 

((ApplicationMediatorThread) runningThreads.elementAt (i)) .stop(); 

runningThreads.removeAIIEIementsQ; 
viewListeners.removeAIIEIementsQ; 
try j 

for (int i = 0; i < viewControllers.sizeQ; | 

((ViewController) viewControliers.elementAt(i)) .setEnobled(false); 
((ViewController) viewControllers.elementAt(i)) .exit (); 

for (int i = 0; i < applicationMediators.sizeQ; i++) | 

((ApplicationMediatorJ applicationMediators.elementAt(i)j .setEnabled(false); 
((ApplicationMediator) applicationMediators.elemenlAt(i)) .exit(); 

| catch (Exception noProblem) | 

viewControllers = null; 
applicationMediators = null; 
runningThreads = null; 
runningThreads = null; 
data = null; 

i 

1 FIG. 17F 
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/ 

ApplicotionMediotodmpl.cleorO : AUS8- 1999-0694 

/** 

Clear the Applicationk'c-diator by - clear my cii allocated VlewControllers 

* and ApplicationMediators. All data is set to null, but lists are 

* not destroyed. A 'cleared' ApplicationMediator can be used again. 

* If this methed is overriden in a subclass, be sure to invoke 

* super.clear(); 

*/ 

public void clearQ j 

synchronized (this) } 

/* Used for style 1 event dispatching. Leave this code commented. ♦/ 
//if (this.eventThread != null) { 
// try J 

// eventThread.stop (); 

// | catch (Exception e) | 

// 
u\ 

/* Used for style 2 event dispatching. Leave this code commented. */ 

for (int i = 0; i < runningThreads.sizeQ; i++) { 

^ ((ApplicationMediatorThread) runningThreads.elementAt (i)) .stopQ; 

runningThreads.removeAIIEIementsQ; 

// 
try { 

for (int i = 0; i < viewControllers.sizeQ; i++) | 

((ViewController) viewControllers.elementAt(i)) .setEnabled(false); 
^ ((ViewController) viewControllers.elementAt(i)) .clear (); 

for (int i = 0; i < applicationMediators.size(); i++) { 

JjApplicationMediator) applicationMediators.elementAt(i)) .setEnabled(false); 
^ ((ApplicationMediator) applicationMediators.elementAt(i)) .clear(); 

| catch (Exception noRealProblem) j 

viewControllers = null; 
' applicationMediators = null; 
data = null; 

FIG. 1 7G 
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* Initalize the ApplicotionMediotor using the listeners of on 

* existing ApplicotionMediotor. 
*/ 

public -oid init(ApplicationMediator applicationMediator) { 

if (applicationMediator instanceof ApplicationMediatorlmpi) \ 

ApplicationMediatorlmpi o = (ApplicationMediatorlmpi) applicationMediator; 
requestListeners = (Vector) a.requestListeners.clone(); 
placementListeners = (Vector) a.placementl_isteners.clone(); 
topListeners = (Vector) a.topListeners.clone(); 
addViewListener(a); 



i 



initQ; 



FIG. 17H 
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* When new data arrives allow the ViewControllers 

♦ and ApplicationControllers to be refreshed also. 

v. 

public void refresh(Object data) { 
this.data = data; 
try { 

synchronized (viewControllers) j 

for (int j = 0; j < viewControllers.size(); j++) { 

((ViewController) viewControllers.elementAt(j)). 
refresh(doto); 

| catch (Exception noReolProblem) | 
try | 

synchronized (applicationMediators) \ 

for (int j = 0; j < applicationMediotors.sizeQ; { 
((ApplicationMediator) applicationMediators. 
elementAt(j)).refresh(data); 

, i 1 

catch (Exception noReolProblem) { 



FIG. 171 
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* A ViewEvent is delivered. Process it using Threading style 1 or 2. In 

* the end, the processViewEvent will be called on the subclass. 

•/ 

public void viewEventPerformed (ViewEvent e) j 

/* Used for style 2 event dispatching, start an inner class thread */ 
ApplicationMediatorThrend t = new ApplicotionMediatorThread (e); 
runningThreads.addElement (t); 
t.start (); 

/* Used for style 1 event dispatching. Leave this code commented. */ 

//ViewEvent saved = saveViewEvent(e); 

//if (eventThread == null | | leventThread.isAliveQ) | 

// finished = false; 

// eventThread = new Thread(this); 

// eventThread.start (); 

u\ 

//synchronized (this) | 
I j notifyO; 

1 FIG. 17 J 
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♦ This method is used in style 1 threading. Rename this to run () 

* and uncomment the code as described in the class javadoc. 

public final void run2 () j 

/* Used for style 1 event dispatching. Leave this code commented. */ 

/* 

while (true) j 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) { 

handleViewEvent (event); 
j else j 

waitForEvent (); 

if (finished) j 

// something went wrong with the thread so hose this loop 
break; 

. i 



i 

v 



FIG. 17K 
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* Private class to handle executions of ViewEvents () on another thread. 
**/ 

private class ApplicationMediatorThread extends Thread j 

A* 

* The current event 
private ViewEvent event; 

* Create an ApplicationMediatorThread to process the ViewEvent 

public ApplicationMediatorThread(ViewEvent event) j 
super (); 

this.event = event; 

i 

/« 

* Just call the handleViewEvent method that the subclass will override 

••/ 

public void run () j 
^ processViewEvent (event); 



i 



FIG. 17L 
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f4* 



h 

* Save the current ViewEvent on a Q 

y 

private final ViewEvent saveViewEvent (ViewEvent e) j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return viewEventQueue.add(e); 
return null; 

i 

A* 

♦^Method: return the first view event saved. Used by the Q'ing system. 

private ViewEvent getViewEvent () j 

/♦ Used for style 1 event dispatching. Leave this code commented. ♦/ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

FIG. 1 7M 
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Tronsporter.reQuestEventPerformed(RequestEvent) :AUS8- 1 999-0693 

/** 

* Submit o synchronous request. For each Destination that is listening for 

* the current family of RequestEvents (the major code), send the RequestEvent 

* to the Destination for processing. If there is a problem, throw 

* a RequestException. Continue processing the RequestEvent as long 

* as a RequestException is not thrown by a Destination and the RequestEvent 

* is not consumed. 

* <p> 

* if tagging is enaDiea, then append a status tag to the RequestEvent. 
*<p> 

* Destinations are processed in the following FIFO order: 

* 1- All using "!" (priority). 

* 2- All using a major code. 

* 3- All using "V\ 
*<p> 

* ©exception RequestException if the Request can't be submitted 
*/ 

public void requestEventPerformed(RequestEvent request) throws RequestException { 
if (lenabled) j 

^ throw new RequestException("Transporter disabled"); 

/* Try to tag the request */ x 
if (tagging) v 2606 
request.setStatus(request.getStatus() + "[Transporter]"); 

/♦ Process PRIORITY, major and then WILDCARD destinations */ 
processDestinationsf request, getDestinations(PRIORITY)); 
processDestinationsfrequest, getDestinations(request.getMajor())); 
processDestinations(request, getDestinations(WI LDCARD)); 

1 FIG. 26 F 

A* 

* Submit an asynchronous request. See the synchronous 

* requestEventPerformed for more information. 

V 

public void requestEventPerformed(RequestEvent request, 
RequestResponseListener caller) throws RequestException j 
if (lenabled) j 

throw new RequestException^'Transporter disabled"); 

if (tagging) 

request.setStatus(request.getStatus() + 

"[Transporter async.]"); **^2608 

//start an inner class thread 

TransporterThread t = new TransporterThread(request, caller); 

runninqThreads.put(request, t); 

t.start(); 

1 FIG. 26G 



2610 
/ 

TronsDorter.TronsDorterThreQd :AUS8-1 999-0693 
/•• 

* Private, doss -o handle execut ,nn<; «f submitsQ cr. another 
thread. 

••/ 

private class TransporterThread extends Thread j 

A* 

* The current request 

A* 

private RequestEvent request; 

/** 

* The caller of submit that we will call back 
private RequestResponseListener caller; 



/** 

* Create a transporter thread 

••/ 

public TransporterThread(RequestEvent request, 
RequestResponseListener caller) j 
superQ; 

this.request = request; 
this.caller = caller; 

\- 

* Just call the synchronous version of 
requestEventPerformed() 

•*/ 

public void run() } 
try j 

requestEventPerformed(request); 

caller.requestResponse(request); 
( catch (RequestException yikes); { 

caller.requestException(yikes); 
j finally J 

runningThreods.remove(request); 

i 1 

FIG. 26 H 
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\ 

package com.ibm.jtcx.serialization;- . 

import java.io.txternalizable; 
import java.io.lOException; 
import java.io.Objectlnput; 
import java.io.ObjectOutput; 
A* 

* Default type comment. 
* 

* <P> INVARIANT: 

V 

public class BaseData implements Externalizable j 
private Object[] data = null; 

A* 

* BaseData constructor comment. 

•/ 

public BaseOata() { 
this(O); 

A* 

* BaseData constructor comment. 

* Qparam dataArray java.lang.Object[] 
*/ 

public BaseData(int count) j 
super(); 

setData(new Object[count]); 

A* 

* Default method comment 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©return java.lang.Object[] 
*/ 

public final Objectf], getDataQ j 
return data; 

i 

FIG. 107 A 



10700 
\ 

* Default method comment. 
* 

* <P>PRE: 

* <P>POS1: 

* ©return Parameter not modified 

* ©return javd.lang.Object 

* ©param index int 

public final Object getData(int index) | 
Object retVal = null; 

if ((data != null) && (index < data.length)) | 
retVal = data[index]; 

i 

return retVal; 

i 

/*♦ 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* ©return Parameter not modified 

* ©param in Objectlnput 

public void readExternal(ObjectInput in) 

throws ClassNotFoundException, lOException j 

setData((Object[])in.readObject()); 

i 

/** 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©param dataArray java.lang.Object[] 
V 

public final void setData(Object[] dataArray) j 
data = dataArray; 

i 
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* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 

* 

* ©return Parameter not modified 

* ©param index int 

* ©param dotaElement java.lang.Object 
*/ 

public final void setData(int index, object dataElement) [ 
if ((data != null) ScSc (index < datalength)) | 
data[index] = dataElement; 

/*♦ 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 
* 

* ©return Parameter not modified 

* ©param out ObjectOutput 
*/ 

public void writeExternal(ObjectOutput out) throws lOException j 
out.writeObject(getDataQ); 
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package com.ibm.jtcx.serialization; 

java.io.Externalizable; 
java.io.IOException; 
java.io.Objectlnput; 
java.io.ObjectOutput; 
java.math.BigDecimal; 
java.math.Biglnteger; 
java.util.Oote; 
java.util.Enumeration; 
java.util.GregorianCalendar; 
java.util.Hashtable; 
java.util.SimpleTimeZone; 
java.utii.TimeZone; 
java.util.Vector; 



import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 

/•• 

* Base class of data objects that require small serialization. The 

* attributes of the data object are stored in an array and the elements 

* of the array are written individually. 
* 

* <P>INVARIANT: 
V 

public class BaseDataS extends BaseData implements Externalizable | 
A* 

* Default constructor. 

•/ 

public BaseDataSQ j 
^ superQ; 

/*♦ 

* Creates a new <code>BaseDataS</code> object with a data array of 

* size <code>count</code>. 
* 

* @param count the size of the data array containing the attributes 
*/ 

public BaseDataS(int count) { 
super(count); 
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A* 

* Reads the array of data elements from the stream. The responsibility 

* of reading the individual element is left to the 

* <code>BaseSerializer</code> via <code>readObject()<code>. 
* 

* ©param in the input stream that contains the serialized object 

* ©exception ClassNotFoundException thrown if 

* <code>8aseSerializer</ccde> rails to read the object from the oirsa.^ 

* ©exception lOException thrown if 

* <code>BaseSerializer</code> fails to read the object from the stream 

* ©see BaseSerializerjjfreadObject 

v 

public void readExternal(Objectlnput in) 

throws ClassNotFoundException, lOException { 

int size = in.readShort(); 

if (size == -1) j 

setData(null); 

( else | 

Object[] array = new Object[size]; 

for (int i = 0; i < size; i++) j 

array[i] = BaseSerializer.getlnstanceQ.readObject(in); 

i 

setData(array); 

* Writes the array of data elements. The responsibility of writing the 

* data elements is left to <code>BaseSerializer</code> via 

* <code>writeObject()</code>. 

* ©param out the output stream to which the data elements will be 

* written 

v 

public void writeExternal(ObjectOutput out) throws lOException { 
Object[] array = get0ata(); 

if (array == null) { 

out.writeShort(-l); 

| else j 

out.writeShort(array.length); 

for (int i = 0; i < array.length; i++) j 

BaseSeriolizer.getInstQnce().writeObject(out, array[i]); 

i 

i 
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package com.ibm.jtcx.serialization; 



impor 
impon 
impor 
impor 
impor 
impor 
impor 
impor 
impor 
import 



java.io.*; ~ — 

jcvc;rrcih.Big!n 4 .eyer; 
java.math.BigDecimai; 
java.util.Date; 

java.utii.GregorianColendar; 

javo.util.Hashtable; 

java.util.SimpleTimeZone; 

java.util.StringTokenizer; 

java.util.TimeZone; 

java.util.Vector; 



/ 



The <code>Seriatizer!F</code> that is used as the base level 
serializer. It contains three tobies used to serialize objects: 
<br><ul> 

<li> codeTable: the table containing the serialization code of 

an object based on the name of the class 
<li> nameTable: the table containing the name of the class 

based on the serialization code 
<li> seriaiizationToble: the table containing the serializer of 
an object based on its serialization code 

</ul> 
<br><br> 

<code>BaseSerializer</code> delegates the responsibility of 
serializing the. objects to the <code>SerializerIF</code> associated 
with that class or to the object itself if it implements 
<code>Externalizable</code>. 

public class BaseSerializer implements SerializerIF { 
static private final int NULLOBJECT = 0; 
static private final int OTHER = OxOOff; 

static private final String HASHTABLE_SER = "ClassNameHash.ser"; 
static private final String INLFILE = "ClassNames.ini"; 

static private Hashtoble codeTable = null; 

static private Hashtoble nameTable = null; 

static private Hashtoble serializerTable = null; 

static private BaseSerializer instance = null; 

class BigDecimalSerializer implements Serializer IF j 

public Object readObject(Objectlnput in) throws CiassNotFoundException, lOException j 
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int scale = in.readShort(); 
int size = in.readShortQ; 
byte[] bytes = new bytefsize]; 
in.readFully(bytes); 

Biglr.^cger temp = new Biglnteger(bytes); 
return new BigDecimal(temp, scale); 

public void write0bject(0bject0utput out, Object element) throws IOException j 
BigDecimal bigD = (BigDecimal)element; 

int scale = biqD.scale(); 
bigD.setScale(O); 

byte[] bytes = biqD.toBiglnteger().toByteArray(); 
bigD.setScale(scale); 

out.writeShortfscale); 

out.writeShort(bytes.length); 

out.write(bytes); 



class BiglntegerSerializer implements SerializerIF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, IOException 

int size = in.readShort(); 
byte[] bytes = new bytefsize]; 
in.readFully(bytes); 

return new Biglnteger(bytes); 

public void write0bject(0bject0utput out, Object element) throws IOException j 
byte[] bytes = ((Biglnteger)element).toByteArray(); 

out.writeShort(bytes.length); 
out.write(bytes); 



class BooleanSerializer implements SerializerIF } 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, IOException 

int value = in.readByteQ; 

return (value == 1) ? Boolean.TRUE: Boolean.FALSE; 

public void write0bject(0bject0utput out, Object element) throws IOException j 
out.writeByte(((Boolean)element).booleanVolue() ? 1 : 0); 
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class ByteSerializer implements SerializerlF j 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, IOException | 
byte value = in.readByteQ; 

^ return new Byte(value); 

public void writeObject(ObjectOutput out, Object element) throws IOException { 
^ out.writeByte(((Byte)element).byteValue()); 

class CharacterSerializer implements SerializerlF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, IOException j 
char value = in.readChar(); 

^ return new Character(value); 

public void writeObject(ObjectOutput out, Object element) throws IOException { 
out.writeChar(((Character)element).charValue()); 

i 1 

class OateSerializer implements SerializerlF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException IOException [ 
long value = in.readLongQ; 

^ return new Date(value); 

public void writeObject(ObjectOutput out, Object element) throws IOException \ 
^ out.writeLong(((Date)element).getTime(j); 

class DoubleSerializer implements SerializerlF { 

public Object readObject(Objectlnput in) throws ClassNotFoundException, IOException j 
double value = in.readDouble(); 

^ return new Double(value); 

public void writeObject(ObjectOutput out, Object element) throws IOException { 
^ out.writeDouble(((Double)element).doubleValue()); 
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class FloatSerializer implements SerializerlF { 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException } 
float value = in.readFloat(); 

return new Float(value); 

public void write0bject(0bject0utput out, Object element) throws lOException \ 
out.writeFloat(((Float)element).floatValue()); 

{ i 

class GregorianCalendarSerializer implements SerializerlF | 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException j 
long time = in.readLongQ; 
Date date = new Date(time); 
SerializerlF serializer = BaseSerializer.getInstance(); 
TimeZone tz = (TimeZone)serializer.readObject(in); 

GregorianCalender gCalender = new GregorianCalendar(tz); 
gCalendar.setTime(date); 

return gCalendar; 

public void write0bject(0bject0utput out, Object element) throws lOException { 
GregorianCalendar temp = (GregorianCalendar)element; 

Date date = temp.getTime(); 
TimeZone tz = temp.getTimeZone(); 

out.writeLong(date.getTimeO); 

SerializerlF serializer = BaseSerializer.getlnstance(); 

serializer.writeObject(out t tz); 

{ i 

class IntegerSerializer implements SerializerlF { 

public Object readOb ject(Object Input in) throws ClossNotFoundException, lOException } 
int value = in.readlnt(); 

return new Integer(value); 

public void writeObject(0bject0utput out, Object element) throws lOException J 
out.writelnt(((lnteqer)element).intValue()); 

{ I 

class LongSerializer implements SerializerlF j 

public Object reod0bject(0bjectlnput in) throws ClossNotFoundException, lOException j 
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long value = in.readLong(); 
return new Long(value); 

public void wriisOuject(ObjectOutput out, Object element) throws lOException | 
out.writeLong(((Long)element)JongValue()); 



class ObjectArraySerializer implements SerializerIF { 

public Object read0bject(0bjectlnput in) throws ClassNotFoundException, lOException { 
int size = in.readShort(); 

0bject[] array = new Object[size]; 
for (int i = 0; i < size; i++) } 

SerializerIF serializer = BaseSerializer.getlnstanceQ; 

array[i] = serializer.readObject(in); 

return array; 

i 

public void write0bject(0bject0utput out, Object element) throws lOException j 
0bject[] array = (Object[])element; 

out.writeShort(array.length); 

for (int i = 0; i < array length, i++) { 

SerializerIF serializer = BaseSerializer.getInstance(); 

serializer.writeObject(out, array[i]; 



class ObjectSerializer implements SerializerIF i 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException j 
return in.readObject(); 

j 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
out.writeObject(element); 

i 1 

class ShortSerializer implements SerializerIF j 

public Object reodObject(Objectlnput in) throws ClassNotFoundException, lOException j 
short value = in.readShort(); 

return new Short(value); 
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public void writeObject(ObjectOutput out, Objed element) throws lOException { 
out.writeShort(((Short)element).shortVaiueQ); 

^ I 

class SimpleTimeZoneSerializer implements SerializerIF } 

public Object readObject(Objectlnput in) throws ClossNotFoundException, lOException } 
int offset = in.readlnt(); 

SerializerIF serializer = BaseSeriolizer.getlnstonce(); 
String id = (String)serializer.readObject(in); 

return new SimpleTimeZone(offset, id); 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writeInt(temp.getRowOffset()); 

SerializerIF seriolizer = BaseSerializer.getlnstance(); 

serializer.writeObject(out, temp.getlD()); 

{ I 

class StringSerializer implements SerializerIF { a 

public Object readObject(0bjectInput in) throws ClossNotFoundException, lOException j 
int size = in.readShortQ; 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new Strinq(bytes); 

public void writeObjectfObjectOutput out, Object element) throws lOException j 
byte[] bytes = ((String)element).getBytes(); 

out.writeShort(bytes.length); 
out.write(bytes); 

^ i 

class VectorSerializer implements SerializerIF j 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException, lOException | 
int size = in.readShort(); 

Vector vector = new Vector(size); 
for (int i = 0; i < size; { 

SerializerIF serializer = BaseSerializer.getlnstance(); 

vector.addElement(serializer.readObject(in)); 

i 
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return vector; 

j 

pub'ic vc:d wr:teObject(Cbjr.c{Cutpjt -out. Cuject eiement) throws lOException j 
Vector temp = (Vector)element; 

0bject[] orroy = new Object[temp.size()]; 
for (int i = 0; i < orroy.length; i++) j 
^ arroy[i] = temp.elementAt(i); 

out.writeShort(array.length); 

for (int i = 0; i < orroy.length; i++) | 

SeriolizerIF serializer=BaseSeriolizer.getInstance(); 

serializer.writeObject(out, array[i]); 

* Default constructor. The constructor is private becouse this is a 

* singleton class. When the object is constructed, it initializes its 

* tables. 

*/ 

private BaseSerializerQ j 
j in»(); 

Adds the given elements to the three tables. 

©param className the name of the class 

@param code the code for the given closs 

* ©param seriolizer the object responsible for serializing the given 

* class 

V 

private void addDataToTables(String className, Number code, SeriolizerIF seriolizer) } 
getCodeToble().put(code, className); 
getNameTable().put(className. code); 

if (seriolizer != null) } 

^ getSerializerToble().put(code. seriolizer); 
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/♦* 

* Creates the codes and serializer objects for the default serialization 

* classes and adds them to the tables. The tables are then written to 

* a serialized file. 

private void createDefauItTablesQ j 

addDataToTables(BigDecimal.class.getName(), new Byte((byte)1), new 
BigDecimalSerializer()); 

addDotaToTables(Biglnteger.class.getNameQ, new Byte((byte)2) ( new BiglntegerSerializerQJ; 

addDataToTables(Boolean.class.getName(), new Bvte((byte)3), new BooleanSerializerQ); 

addDataToTablestByte.class.getNameO, new Byte((byte)4), new ByteSerializerQ); 

addDataToTables^haracter.class.getNameQ, new Byte((byte)5), new CharacterSerializerQ); 

addDataToTables(Date.class.getName(), new Byte((byte)6j, new DateSerializer()); 

addDataToTables(Double.class.getName(), new Byte((byte)7), new DoubleSerializerQ); 

addDataToTables(Floatxlass.getName() t new Byte((byte)8) t new FloatSerializer()); 

addDataToTables^GreqorianCalendar.class.getNameO, new Byte((byte)9), new 
GregorianCalendarSerializerQ; 

addDataToTables(lnteger.class.getName(), new Byte((byte)lO), new IntegerSerializerQ); 

addDataToTablesfLong.class.getNameQ, new Byte((byte)1 1), new LongSerializerQ); 

addDataToTablesfShort.class.getNameQ, new Byte((byte)12), new ShortSeriolizer()); 

addDataToTables(SimpleTimeZone.class.getName() I new Byte((byte)13), new 
SimpleTimeZoneSerializer()); 

addDataToTablesfString.class.getNameQ, new Byte((byte)H), new StringSerializerQ); 

addDataToTablesfVector.class.getNameQ, new Bytef(bytej15), new VectorSerializerO); 

addDataToTablesiObject.class.getNameQ, new Byte((byte)1 6). new ObjectSerializerQ); 

writeTables(); 

* Returns an instance of the table of class names, keyed by their code. 

* if the table does not exist, it is created. 
* 

* ©return The table of class names. 

V 

protected Hashtable getCodeTable() j 
if (codeTable == null) { 

codeTable = new Hashtable(); 
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return codeTable; 

* Return? cn instance r» <code>BaseSenalizer</code>. 

* ©return An instance of <code>BaseSeriatizer</code>. 
•/ 

public static Serialized getlnstanceQ | 
if (instance == null) | 

instance = new BaseSerializerQ; 

i 

return instance; 

* Returns an instance of the table of codes, keyed by their 

* corresponding class name. 

* If the table does not exist, it is created. 



* ©return The table of codes. 

v 

protected Hashtable getNameTable() { 
if (nameTable == null) j 

nameTable = new Hashtable(); 

i 

return nameTable; 

* Returns an instance of the table of serializes, keyed by their 

* corresponding code. 

* If the table does not exist, it is created. 
* 

* 9 return The table of class names. 
*/ 

protected Hashtable getSerializerTable() j 
if (serializerTable == null) | 

serializerTable = new Hashtable(); 

i 

return serializerTable; 

* Initializes the hashtable from either a serialized hashtable or from 

* an ini file. 
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protected void init() { 

File seriolizedFile = new File(HASHTABLE..SER); 
File iniFile = new File(INLFILE); 

if (serializedFile.exists()) { 

readSerializedFile(serializedFile); 

\ else { 

if (iniFile.existsQ) j 

readlniFile(iniFile); 

i 

creoteDefaultTables(); 

i 

* Gets the value of the serialization code from the table based on 

* the className provided. The value returned can either be a 

* <code>Byte</code> or an <code>Integer</code>. The return value 

* will be a <code>Byte</code> if the className is one of the base 

* data types. 
* 

* ©return The serialization code of the className. 

* @param className the name of the class 

V 

private Number lookupCode(String className) j 
Number code = null; 

if (className != null) j 

code = (Number)getNameTable().get(className); 

i 

return code; 

i 

* Looks up the hashcode in the table and returns the String value of 

* the hashcode. If the hashcode does not exist in the table 

* <code>null</code> is returned. 
* 

@return The object that was stored in the table with the given 

* hashcode. 

* @param hashcode the hashcode that will be used to look up the value 
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private String lookupName(Number code) { 
String className = null; 

if (code != null) { 

className = (String)getCodeTable().get(code); 

! 

return className; 



* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* ©return Parameter not modified 

* ©return com.ibm.jtc.util.SerializerIF 

* @param code int 

*/ 

private SerializerIF lookupSerializer(Number code) { 
SerializerIF serializer = null; 

if (code != null) j 

serializer = (SerializerlF)getSerializerTable().get(code); 

return serializer; 

i 

/** 

* Default method comment. 
* 

* <P>PRE: 

* <P>P0ST: 

* 

* ©return Parameter not modified 

* ©param iniFile iava.io.File 

v 

private void readlniFile(File iniFile) | 
BufferedReader in = null; 

try | 

in = new BufferedReader(new FileReader(iniFile)); 

for (String inLine = in.readLine(); inLine != null; inLine = in.readLine()) \ 
String trimLine = inLine.trimQ; 
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if ((trimLine.length() > 0) && 

!trimLine.startsWith( , '| M )) { 

S*ringTokenizer tokenizcr - new StringTc!;enizer(lrimLine}; 

String ciassName = tokenizer.nextTokenQ; 

Integer code = new lnteger(className.hashCode()); 

SerializerIF serializer = null; 

if (tokenizer.hasMoreTokensQ) j 

String serializerName = tokenizer.nextToken(); 

try j 

serializer = (SeriQlizerlF)Class.forName(serializerName).newlnstonce(); 
j cotch(Exception e) \ \ 

| catch ^Exception throwAway) { 
{ finally 
try j 

in.closeQ; 
j catch (Exception throwAway) { 

i 

writeTables(); 

i 

/** 

* Reads the object from the stream by first reading the code for the 

* element then reads the appropriate data for that object. 
* 

* ©return The object that was read from the stream. 

* Oparam in the input stream that contains the object 

*/ 

public Object readObject(Objectlnput in) 

throws ClassNotFoundException, lOException { 
Object retVal = null; 
Number code = null; 

byte baseCode = in.readByte(); 
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if (baseCode == NULL^OBJECT) j 
retVal = null; 

j else j 

If (beseCode i= OTHER) } 

code = new Byte(baseCode); 

| else | 

int secondCode = in.readlnt(); 
code = new Integer(secondCode); 

Serialized F seriolizer = lookupSeriolizer(code); 
if (seriolizer != null) j 

retVal = serializer.readObject(in); 

| else { 

String className = lookupName(code); 
try { 

retVal = Closs.forName(className).newlnstance(); 

if (retVal instanceof Externalizable) j 

((Externalizable)retVal).readExternal(in); 

} else | 

retVal = in.readObject(); 
i catch(Exception e) { 



return retVal; 



* Reads the file containing the serialized hoshtables of data. 

* ©param serializedFile the file containing the serialized tobies 

•/ 

private void readSerializedFile(File serializedFile) { 
ObjectlnputStream in = null; 
try | 

in = new ObjectInputStream(new nielnputStream(seriolizedFile)); 
codeToble = (Hashtable)in.readObject(); 
nameTable = (Hashtable)in.readObject(); 
seriolizerTable = (Hashtable)in.readObject(); 
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catch (Exception throwAwoy) j 
finally ) 

tryl • A 

in.close(); 
j catch (Exception throwAway) j | 

if ((codeTable == null) || 

(nameTabie == null) || 
(serializerTable == null)) | 

createDefaultTablesQ; 



* Writes the given object to the stream. First, the code representing 

* the type of the object is written, then the data within the object 

* is written. 
* 

* Oparam out the output stream that will contain the object 

* ©param element the data object that will be written 

V 

public void write0bject(0bject0utput out, Object element) 
throws lOException { 

if (element == null) j 

out.writeByte(NULLOBJECT); 

j else j 

String className = element.getClassQ.getNameQ; 
Number code = lookupCode(className); 

if (code != null) j 

if (code instanceof Byte) j 

out.writeByte(code.byteValue()); 
j else if (code instanceof Integer) j 
out.writeByte(OTHER); 
out.writelnt(code.intValue()); 

i 

SerializerIF serializer = lookupSerializer(code); 

if (serializer != null) J 

serializer.writeObject(out, element); 
{ else if (element instanceof Externalizable) | 

((Externalizable)element).writeExternal(out); 
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| else | 

out.writeObiect(element); 

| else | 

if (element instanceof Objectf]) | 

classNome = Object[j.class.getName(); 

( else | 

clossName = Object.closs.getName(); 

i 

code = lookupCode(classNome); 

SerializerlF serializer = lookupSerializer(code); 

out.writeByte(code.byteValue()); 
serializer.writeObject(out, element); 



* Writes the tables to the file. 
•/ 

private void writeTables() \ 

ObjectOutputStream out = null; 

try I 

File serFile = new File(HASHTABLE_SER); 

out = new ObjectOutputStream(new FileOutputStream(serFile)); 

out.writeOb]ect(getCodeTable()); 
out.writeObjectfgetNameTableQ); 
out.writeObject(getSeriolizerTable()); 
out.writeObject(new Date()); 
catch(Exception e) j 
finally { 
try { 

out.close(); 
| cotch(Exception e) | | 

i 
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